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INTRODUCTION 



1 . INTRODUCTION. 



The purpose 
f i les. 



of the editor is to CREATE, UPDATE and MODIFY text 



The editing commands are divided into groups: those that input 
and output the contents of the edit buffer and those that modify 
the edit buffer. 

Input commands read a text file (or part of it) into the edit buf- 
fer for Later editing. The edit commands are issued for the pur- 
pose of modifying and changing the contents that were input to the 
edit buffer by the input commands. When the contents of the edit 
buffer have been fully updated, the output commands output the 
corrected text file. 

The input file can be modified by insertion, deletion and changing 
of the original contents by issuing the editing commands. The 
command structure allows changes to be made on character level as 
well as on line level. This is accomplished by an implicit 
character pointer, CP. String searches provide a convenient 
method of locating characters for examination and/or modification. 
A macro command facility has been provided to simplify the ex- 
ecution of repetitive command sequences. The editor maintains an 
implicit line numbering system starting with number 1. This num- 
bering system is continually updated as lines are inserted and 
deleted. 

The command structure of the editor is basically the same as the 
text editor on the PDP-10, that of TECO. 

Input to the editor is a continuous stream of characters. The in- 
put is in the form of a text file. This stream of characters is 
considered to be segmented into pages. A page is a string of 
characters up to but not including a form feed character. A page 
is segmented into lines, where a line is defined as a string of 
characters up to and including a carriage return (CR). 

The editor is named edit and is invoked by the command 'edit'. 
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i- fiMURES OF JHE EDITOR- 



2-1- ESC (escape) j^£y- 



The ESC key is used for two purposes: 

1. Striking ESC twice signals the editor to process the 
command string just typed. A command Line is not ex- 
ecuted until two consecutive ESC characters are given. 

2. Striking ESC once following a string argument to an 
editor command delimits the argument from the following 
command sequence or from another string argument. 



Striking ESC echoes a "$" on the console. 



2-2- Character Pointer (CP). 

An implicit character pointer is maintained by the editor and is 
used to facilitate reaching the exact location for desired 
modification and examination. This pointer should be thought of 
as residing between two characters. For example, the CP might be 
positioned as 

rikkel 

A 

(the figure indicates that CP is positioned between "e" and "1". ) 
If characters are inserted, they will be placed at the current 
position of CP. Insertion of a "-", for example, would give the 
following string of characters: 

r ikke-1 

CP 

with CP now located at the end of the insertion. Exact directions 
and commands as how to move and reset the CP are discussed in sec- 
tion 4. 
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2 -3 . Rubout . 

At any time the user may depress the rubout (RUBOUT) key as a 
deletion function- This key deletes the last typed character of 
the command string each time it is depressed. Repeated rubouts 
delete characters from right to left limited only by deleting the 
entire command. Should this happen, the editor will issue a new 
prompt character ("*"). When the rubout key is depressed, it will 
echo the character deleted on the console. 

For example: 

mary had a baddablittle lamb, 
rubouts 
will be entered as: 

mary had a little lamb, 

2-4- Backspace. 

Typing the BACKSPACE key deletes the last typed character in the 
command buffer and the cursor is moved one step backwards. This 
may be done repeatedly, also across line bounds. 

2-5. Buffer Deletion (SIBL*)- 

If the user depresses the CTRL key and types "x" during the 
process of writing a command, the entire command up to that point 
will be discarded, and the editor will respond with a new promp- 
ting "*". 
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3. COMMAND STRUCTURE. 

A command directs the editor to perform a desired operation. Each 
command consists of a single Letter, a double Letter or a special 
graphic, called the command code. The command code can have an 
optional integer argument n, preceding it, or it can be followed 
by an optional string argument. 

The letter used as command code may only be the lower case letter, 
except where explicitly stated in the following text. Numeric ar- 
guments are always taken as decimal integers. 

The editor accepts for execution either a single command or a com- 
mand string. 

I-l- SincjJLe Command. 

The single command has the following format: 

(n)CODE(string$) 

whe re : 

n is an optional integer. 

CODE is a letter, a double letter or a special graphic. 

string represents an optional string of characters. 

$ is an echo from depressing the ESC key. 

3.2. Command String. 

The user can queue two or more commands for sequential execution 
by the editor. This series of commands is called a command 
string. Each command code must be delimited from the next command 
by pressing the ESC key once, which will echo "$" on the console. 
(If the command cannot be misinterpreted as a parameter to the. 
preceding command, the depression of the ESC key may be omitted. 
New users are advised not to use this facility, due to the pos- 
sible catastrophic results from erroneous concatenations of com- 
mand codes.) 

The command string format is 

(n)CODE(st ring$) (n) CO DE (stringS) ... (n) CODE (string$) 

Spaces and carriage returns (CR) may be inserted between the com- 
mand codes to ease reading and to carry the command string over to 
another line on the console. These extra characters have no ef- 
fect on the command execution, but are of course significant 
within a string argument. 
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3.3. Conventions. 

If a control key is depressed (other than ESC, RUBOUT, and CRTL), 
nothing will be echoed, but the character value is significant. 
Three characters are ignored on input by the editor: 



null 





line feed 


10 


de le te 


1 27 
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k' EJ>IIOR COMMANDS. 

Editor commands are discussed in the following order in this sec- 
t ion : 

1. File specification commands. 

2. Input commands. 

3. Buffer examination commands. 

4. CP positioning commands. 

5. Edit commands. 

6. Output commands. 

7. Special commands. 



All of the commands are discussed on the pages following and a 
summary table is provided for reference at the back of this 
manual . 



If the editor is invoked with arguments as follows: 
ed it -f n. ext 




edit fn 

the file ' f n BCPL' will be chosen as input file. Invoking the 

editor as specified will cause the first page of the input file to 

be read into the edit buffer. A page is defined as a string of 
characters terminated by a form feed. 

If the editor is invoked with no arguments the user must at least 
specify the output file. If the user wants to modify an existing 
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file this file must be specified as an input file- The commands 

grlfn$lext$$ 
gwOf n$0ext$$ 

will select the file 'Ifn Iext' as input file and 'Ofn Oext 1 as 
output file. The edit buffer will not be affected by these com- 
mands . 

The command 

gt$0fn$0ext$$ 

appends output to file 'Ofn Oext 1 . 

The two strategies (specifying the input by means of an argument 
for 'edit' and explicitly using a 'gr' command) must not be con- 
fused. 

If the user wishes to add new text to a file, the insert command 
may be used and we refer to its description in section 4.5. 



£.2. Ingut commands. 

Read ( yank ) a gage. 

By issuing the yank command, 



the editor will read a page of the symbolic text from the input 
file into the edit buffer. The form feed will be read but will 
not be stored in the edit buffer. The CP will be positioned to 
the start of the edit buffer. The string will be input until a 
form feed character is detected or end of file is reached or the 
edit buffer becomes full. If the capacity of the edit buffer is 
exceeded, the message: 

BUFFER IS FULL, Y OR A INPUT TERMINATED 

is printed on the console. Since this message indicates that a 
partial page has been read into the edit buffer, the user must 
output the buffer before the remaining part of the page may be 
read in. 

Aj2E£D£l a gage. 

To append a further page to the present contents of the edit buf- 
fer, issue the aggend command 



This will read a page of input from the input file and append it 
to the end of the text contained in the buffer. The CP will be 
positioned before the first character of the new page. If, while 
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appending, the edit buffer's capacity is exceeded, the message: 

BUFFER IS FULL, Y OR A INPUT TERMINATED 

is printed on the console. The buffer must be output before the 
rest of the page may be input to the edit buffer. 

ii-3. Examination of the Buffer. 

To type the entire contents of the edit buffer on the console, the 
user must issue the command: 

ht 

This command has no effect on the positioning of CP. If the user 
wishes to examine only a portion of the edit buffer, he should is- 
sue the command: 

nt 

If n is positive n lines are typed from the edit buffer, starting 
at the current position of CP. If n is negative the preceding n 
lines are typed, ending just before the current position of CP. n 
can be omitted in which case one line is typed. CP is not affec- 
ted by this command. 

k'k* Character Pointer (CP) Positioning Commands. 

To move CP to the beginning of the edit buffer, the user issues 
the command 



Jump, to line n. 

By issuing the command: 

the user can position the CP at the beginning of line n, counting 
from the start of the edit buffer. The CP will be positioned 
before the first character of line n. 

Move GP n lines. 

To move the character pointer from line to line, issue the com- 
mand: 

nl 

CP will move n lines from the present position of the CP, and 
become located before the first character position of the new 
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Li ne. 



for n > 



move forward (down) through n carriage 
returns. 



for n < 



move backwards (up) through -(n+1) carriage 
returns and move forward 1 character. 



for n = 



position CP to the beginning of the current 
Line. 



If these operations cause the editor to try to pass the bounds of 
the text contained in the buffer, the CP is positioned to the 
first or Last character position within the buffer. In this case, 
the command is equivaLent to either the b or the z command. 

B2)l£ £E £2 fe^aiQD2D2 2f ilDS- 

To move the CP to the beginning of the current Line, issue the 

command : 

L (or OL) 

CP wiLL move to the beginning of the Line, in front of the first 
character of the Line. 

Move CP n characters. 

To move CP n characters from its present position, the user shouLd 

issue the command 



where : 



for n > 



CP is moved n character positions forward (to 
the ri ght) . 



for n < 



CP is moved n character positions' backwards 
(to the Left) . 



for n = 



no effect on CP. 



MoyS £P 12 £D£l 2f ££Jit kyii§£« 
By issuing the command: 
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the CP will be moved to the end of the edit buffer. 

The examples on the following pages will illustrate the various 
possibilities open to the user for moving the CP from character to 
character and from line to line. 

Examples showing the CP positioning commands. 

The numbers in parentheses in the following examples represent the 

implicit line numbering system maintained by the editor. 

Let the contents of the edit buffer be: 

(1) ma ry had a little lamb, 

(2) its fleece was white as snow, 

(3) and everywhere that mary went 



command resul£ 
b$$ 



(1 ) mary had a little lamb, 

CP 

(2) its fleece was white as snow, 

(3) and everywhere that mary went 



3j$$ 



(1) mary had a little lamb, 

(2) its fleece was white as snow, 

(3) and everywhere that mary went 

CP 



-1 l$$ 



(1 ) mary had a little lamb, 

(2) .its fleece was white as snow, 

CP 

(3) and everywhere that mary went 



z$$ 



-10m$$ 



(1) mary had a little lamb, 

(2) its fleece was white as snow, 

(3) and everywhere that mary went 

CP 



(1 ) mary had a little lamb, 

(2) its fleece was white as snow, 

(3) and everywhere that mary went 

CP 
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L$$ 



45m$$ 



(1) mary had a Little Lamb, 

(2) its fLeece was white as snow, 

(3) and everywhere that mary went 



CP 



(1 ) mary had a LittLe Lamb, 

(2) its fLeece was white as snow, 

(3) and everywhere that mary went 

CP 



-14L$$ 



(1) mary had a LittLe Lam»b, 

CP 

(2) its fLeece was white as snow, 

(3) and everywhere that mary went 



£-5- Text Editing Commands. 

Change a string. 

A search for a string, deLetion of that string and insertion of a 

new string can be accompLished by issuing the command: 

est r i ng1 $st ri ng2$ 

stringl is searched for in a forward direction from the current CP 
position. If found, its first occurrence is repLaced with string2 
, and the CP is positioned to the first character after string2 . 
If the end of the edit buffer is reached before finding stringl , 
the message 

STRING NOT FOUND 'stringl ' 

wiLL be printed on the consoLe and CP will be positioned at the 
beginning of the edit buffer. If the user issues the command 

cstringl $$ 

the editor simpLy deLetes stringl . 
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Examples : 

1. Contents of edit buffer: 

THERE WAS A LITTLEBOY 
With the command 

cB0Y$GIRL$$ 
the edit buffer is modified to 

THERE WAS A LITTLE GIRL 

2. Contents of edit buffer: 

WHO HAD A LITTLY CURLY PIMPLE 
After the command 

cY PIMPLE$$ 
the edit buffer will contain 

WHO HAD A LITTLE CURL 



Insert string- 
To insert a string of characters, the following command can be is- 
sued 

i st r i ng$ 

string will be inserted at the present position of CP. CP will be 
repositioned to the end of the inserted string. 

The following example shows how insertions are made and where the 
CP will be positioned. When a line or lines are inserted, subse- 
quent lines are renumbered by the implicit line numbering system 
maintained by the editor- 
Let the edit buffer contain: 

WHO HAD A LITTLE CURL 

RIGHT IN THE OF HER FOREHEAD 

CP 



Command : 



t t 



7m$i MIDDLE$0l$1 t$$ 

{ type one line 
move CP to beginning of line 
insert "MIDDLE" 
move CP 7 positions forward 
After command execution: 

RIGHT IN THE MIDDLE OF HER FOREHEAD 
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££££££ characters.. 

To delete characters from the edit buffer, the command: 

nd 



can be used. 

for n > 

for n < 



delete n characters forward from (to the right 
of) the present position of CP. 



An example: 
Before : 

Command: 
After: 



delete n characters backwards from (to the 

left of) the present position of CP- for n = 



the command is ignored. 



WHEN SHE WAS GALOOD 

A 

-2d$$ 

WHEN SHE WAS GOOD 
CP 



To delete lines from the edit buffer, the command 

nk 

can be issued, where n represents the number of lines to be 
deleted from the edit buffer. 



for n > 



delete n lines forward from the present 
position of CP, i.e. delete all characters up 
to, but not including, the n'th carriage 
return. 



for n < 



delete -(n+1) lines backwards from the present 
position of CP. 

for n = 

delete every character before CP's present 
position back to, but not including, a car- 
riage return. 

After execution of the command, the CP will be positioned i in- 
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mediately after the position of the Last deleted character. The 
command can be compared in action with the L command, except that 
in the case of the k command, each character that CP passes over, 
i s de Leted . 



The command 



hk 



deletes the entire buffer. 

For example : 

The contents of the edit buffer is: 





li ne 1 




I i ne 2 
CP 






I i ne 3 


command 


result 


-1k$$ 


ne 2 




line 3 


0k$$ 


line 1 




ne 2 




I i ne 3 


1k$$ 


li ne 1 




I i I i ne 3 



Searches. 

The editor will perform a search of the edit buffer for a 

specified string when the command: 

sst ri ng$ 

is issued. The editor searches forward from the present position 
of the CP, and is positioned after the last character of the first 
occurrence of string . If the end of the edit buffer is reached 
before string is encountered, the message: 

STRING NOT FOUND 'string 1 

will be printed on the console. If this happens CP will be 
positioned at the beginning of the edit buffer. 
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Example : 
Before : 



THERE WAS A LITTLE GIRL 

CP 
WHO HAD A LITTLE CURL 
RIGHT IN THE MIDDLE OF HER FOREHEAD 



Command : 



After: 



sOF HER$$ 

search for string "OF HER" 



THERE WAS A LITTLE GIRL 

WHO HAD A LITTLE CURL 

RIGHT IN THE MIDDLE OF HER FOREHEAD 

t 
CP 



A search for a string may be continued by examining subsequent 
pages of the input file. This type of search is activated by 

nstringS 

If string is not found in the current buffer from CP and onwards, 
the editor outputs the buffer to the output file and brings the 
next page from the input file and continues the search at the 
beginning of the new buffer. This process is repeated until the 
string is found or end of file is encountered. 

Should the latter occur, the message 

STRING NOT FOUND •string' 

will be printed on the console. 

A third way of searching for a string throughout the input stream 
is provided: It causes examination of subsequent pages for an oc- 
currence of the string but does not output the pages before that 
page in which string is found. This type of search is called by: 

qst r i ng$ 

If the string is not found in the edit buffer from CP and onwards, 
the editor yanks a new page into the buffer and continues sear- 
ching and yanking until the string is found or end of file is 
reached in which case the message 

STRING NOT FOUND 'string' 

is written on the console. 
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In the q and n commands, the CP is positioned immediately after 
the Located string. If the search is unsuccessful, the CP is 
positioned at the beginning of an empty edit buffer. 

!?3cro command facility. 

To ease repetitive command operations, a macro facility has been 
provided. Only one macro can be defined at a time. To specify 
the contents of the macro command, the user must write: 

xmcommandl ...commandn$$ 

where command has the format: 

(n)CODE(st ring$) 

(See the earlier description of command structure.) No check for 
command errors is given during the macro definition. Errors will 
only be detected during the processing of the macro. 

Execution of a macro command is obtained by issuing the command 

nx 

where n denotes the number of times the command string of the 
macro is to be executed. 

The commands 

x$$ 0x$$ 1 x$$ 

are equivalent and execute the macro once. 

A defined macro may be deleted at any point in the ed i ti ng sessi on 
by issuing the command 

xd 
The contents of the macro may be displayed by typing 

x? 
For example: 



b$$ 

xmcRIKKEI SRIKKE-1 $l$1 t$$ 

x?$$ 

1000x$$ 

xd$$ 



(macro def ini ti on) 
(displays macro definition) 
(executes the macro 1000 times) 
(deletes the macro) 



The above sequence of edit commands specifies that all occurrences 

of "RIKKE1" in the current edit buffer will be changed to 

"RIKKE-1", assuming "RIKKE1 " occurs less than 1000 times. 

If an error occurs during execution of the macro, the appropriate 
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error message will be typed on the console, and the macro ex- 
ecution will be terminated. 

If the macro is 

1 . Undef ined 

2. Defined recursively (e.g. xm3l$x$$) 

the message 

MACRO ERROR 
will appear on the console writer. 



&•£• §u£P.u* Commands. 

Qi4J:E!iJ£ £ti£ puffer. 

The following output commands are provided: 



Output the entire edit buffer to the output 
file, and end with a form feed. 



np 



pw 



Output n lines, starting at the present 
position of CP, and end with a form feed. 

Output the entire buffer to the output file, 
no form feed is written at the end. 



npw 



Output n lines from the edit buffer, starting 
at the present position of CP. No form feed 
is written at the end. 



The command 



will output the current contents of the edit buffer and then copy 
the remainder of the input file to the output file. 

§.y!B^£ ^ytfJSE 2Q£! ££§£! ID DSii buffer • 

The output and read function can be obtained by combining the q 
and the ^ commands (e.g. p$y$$). However, the following command 
accomplishes the same: 
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This operation can be repeated by a 

nr 
command. 

for n < 1 



for n = 1 



for n > 1 



the command is ignored. 



the command is equivalent to the r command. 



the command will alternately output a page and 
read in a new page n times. 



4-7- Special commands- 
command operation 



type the number of lines currently 
in the edit buffer. 

type the number of the line, 
that CP is currently pointing to- 
type the number of characters contained 
in the edit buffer- 
Close input, output files 
and return to the operating system, 
(must be succeded immediately by ESC) 

equivalent to e$o$$ 
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5- SUMMARY. 



£-1" i££££ messages. 



Error messages and their meaning are in the table below- They are 
always printed along with the remainder of the command sequence 
that was interrupted by the error. Errors always terminate ex- 
ecution of a command sequence. 



l££°£ D)§ssage 



Meaning 



INPUT TERMINATED Command string exceeds capacity of the 
command buffer. Input to the command 
string is terminated and whatever has 
been typed in is executed. 

BUFFER IS FULL, Y OR A INPUT TERMINATED 

The edit buffer's capacity is exceeded. 
The read is terminated and only a partial 
page is in the edit buffer. 

MACRO ERROR Macro undefined or called recursively. 

COMMAND UNINTELLIGIBLE 

Editor cannot parse a command. 
STRING NOT FOUND 'string' 

A command has failed during a search. 
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5.2. Summary If^e. gf iiJiiiQS fiPWilDfitS- 

Append a page* 

Reset CP to beginning of edit buffer. 
Search buffer for strl and change to str2. 
Delete n characters from position of CP. 
Output buffer and rest of input file. 
Equivalent to e$o$$ 
Output form feed. 
Take input from file "fn ext". 
Output on file "fn ext". 
Append output to file "fn ext". 
Delete entire buffer. 
Type entire buffer on console. 
Insert str at current position of CP. 
Move CP to beginning of line n. 
Delete (kill) n lines from the current 
position of CP. 

Set CP to beginning of present line. 
Set CP at beginning of line, n lines from 
current position of CP. 
Move CP n character positions. 
Search for str; if not found, output buf- 
fer,read new page and continue search 
through all input. 

Exit from editor, no output of buffer. 
Output entire buffer, add form feed at end. 
Output n lines starting at current position 
of CP, end with form feed. 
Output entire buffer, no form feed at end. 
Output n lines starting at present position 
of CP, no form feed at end. 
qstr$ Search for string; if not found, read and 
continue search through all input. 
Output entire buffer and read in next page. 
Perform r command n times. 
Search edit bufer for str. 

Type n lines, starting at current position 
of CP. 

Execute macro once. 
Execute macro n times. 
Delete macro definition. 
Display current macro definition. 
Define str to be a macro command. 
Read (yank) a page. 
Position CP at end of edit buffer. 
Type number of characters in edit buffer. 
Type number of lines in edit buffer. 
Type number of current line. 
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a 


a 


b 


b 


c 


cstr1$str2$ 


d 


nd 


e 


e 


ex 


ex 


f 


f 


gr 


grf n$ext$ 


gw 


gwf n$ext$ 


gt 


gtf n$ext$ 


hk 


hk 


ht 


ht 


i 


i str$ 


J 


nj 


k 


nk 


I 


I 




nl 


m 


nm 


n 


nstr$ 








P 


P 




np 


pw 


pw 




npw 



r 


r 




nr 


s 


sstr$ 


t 


nt 


X 


X 




nx 


xd 


xd 


X? 


X? 


xm 


xmst r$ 


y 


y 


z 


z 
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